Write down the route a landed record's stale evidence takes, and point two checklist links at the file that holds them - #219
Merged
iderex merged 2 commits intoAug 29, 2026
Conversation
`docs/promotion.md` wrote both of its decision-record links relative to the
repository root rather than to the file carrying them, so each resolved to a
path under `docs/docs/` and neither opened. The label keeps the full path and
the target is now relative to `docs/`, which is how the nine links in
`docs/operator-guide.md` and `docs/privacy.md` are written and why all of
theirs resolve.
The failure it prevents is a reader who follows the checklist to the record
that fixes what a promotion section may not restate and lands on nothing, at
the moment the document sends them away for the answer. Both sites point at
exactly those records.
grep -rn '](docs/' docs/ --include=*.md
exit=1
Refs #218
Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
Two landed records carry pastes that have stopped reproducing, and record 0000 gives a landed record exactly one legal edit, the line naming what superseded it. Which route repairs the rest was written nowhere, so every reader who met one resolved it their own way and the ones who resolved it by editing left nothing behind saying so. The route: a landed record's evidence is never brought up to date, because a paste is a measurement of its date rather than a claim about today. Where the decision still stands on today's evidence, nothing happens. Where the premise fell, the answer is a successor record carrying the fresh measurement, never an edit. The failure it prevents is a forged reading. An edited paste asserts a run that never happened, in the file a later reader trusts most, and afterwards a record whose premise fell and one whose premise held read identically. Records 0012 and 0018 are read against that test in the record's second section, both stand on today's evidence, and neither is touched. Every paste in the new record reproduced at 55ef161. go run ./cmd/lab check . 27 decision records read 0 refused The means is a decision record in docs/decisions/, because this is a rule later work depends on and CONTRIBUTING.md sends such a rule there; nothing else in this tree holds one, and record 0000 already fixes the shape it has to take. Refs #216 Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
iderex
deleted the
docs/the-route-for-stale-evidence-and-two-links-that-do-not-resolve
branch
August 29, 2026 10:19
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two document-only changes on one branch. Both land text and nothing else, so
they share a pull request rather than moving the mainline under each other for
no reason. They are separate commits and separate topics.
#218, the two links that resolve to nothing
docs/promotion.mdwrote both of its decision-record links relative to therepository root rather than to the file that holds them, so each resolved to a
path under
docs/docs/and neither opened. The label keeps the full path andthe target is now relative to
docs/, which is how the nine links indocs/operator-guide.mdanddocs/privacy.mdare written.The done-condition asks that
grep -rn '](docs/' docs/ --include=*.mdreturnnothing. At
36eddf59e199659baa2cf6a6eec2731da697a338:And every link in that file resolves from the directory that holds it:
#216, the route a landed record's stale evidence takes
What was left of that issue was the route by which a landed record carrying
evidence that no longer reproduces is repaired, written down, and both sites
left in whatever state the route says. The route was decided on the issue and
lived only there, so this adds
docs/decisions/0026-evidence-in-a-landed-record-that-stopped-reproducing.md:a landed record's evidence is never brought up to date, because a paste is a
measurement of its date rather than a claim about today. Where the decision
still stands on today's evidence, nothing happens. Where the premise fell, the
answer is a successor record carrying the fresh measurement, never an edit.
Records
0012and0018are read against that test in the record's secondsection, and both stand on today's evidence, so neither is edited and neither
gains a successor.
0012makes itself superseded only if entry four of issue#46 answered source only, and record
0021decides that this board publishessigned downloadable artefacts, so that conditional cannot fire.
0018decidesGPL-3.0 and the three readings it said disagreed now agree with it.
Every paste in the new record was reproduced before it was written, at
55ef1616e1da8889c005fb7f185fae613557e839:One clause of that issue's original done-condition is deliberately not met, and
it is the clause the route overturned. It asks that
git grep -n 'issue #46'return no site asserting an entry is open, and one site still does:
The first two are each about their own record's scope and the issue body puts
them outside its scope; the fourth says the entry is answered. The third is the
one, and under the route above it stays. That clause was written before the
route existed, and the issue's own later statement of what is left replaces it:
the route is decided and written down, and both sites are left in whatever
state the route says.
The means
A decision record in
docs/decisions/, because this is a rule later workdepends on and
CONTRIBUTING.mdsends such a rule there. Nothing else in thistree holds one, record
0000already fixes the shape it has to take, and theexisting checks read that directory, so the artefact is judged by the suites
that already exist rather than by a parallel apparatus.
What I ran
gofmt -lprinted nothing. The checker printed:Every package in the suite reported
ok.What this does not carry
No second reader tonight. Nobody but me has read these two commits, and the
evidence above stands in place of that reading rather than alongside it. Both
changes are text: one moves four link characters, the other adds a file that
nothing imports and no run executes.
Nothing here re-scores the board and neither change claims a re-score. The
record's own second section is a reading taken on 2026-08-29 and is subject to
the rule the record states about pastes.
Closes #216
Closes #218